TPUG - Toronto PET Users Group

home *** CD-ROM | disk | FTP | other *** search

/ TPUG - Toronto PET Users Group / TPUG Users Group CD / TPUG Users Group CD.iso / C64 / T-TPUG Old Monthly Disks / (c)th.d64 / disk util doc < prev next >

Wrap

Text File | 2007-02-11 | 27KB | 525 lines

É1 ╨AGE 1 OF 8 ╬┼╫ ╒╘╔╠╔╘┘ ╫┼─╟┼ (THIRD UPLOAD) ├OMMAND ╙UMMARY * READ DISK ERROR CHANNEL ** SEND ─╧╙ COMMAND TO DISK *A AUTO LINE NUMBERING OR RENUMBERING *B READ OR WRITE A DISK BLOCK *C COPY A FILE OR ENTIRE DISK, CHANGE A FILE TYPE, RECOVER SCRATCHED FILE *D DELETE A RANGE OF LINES *F SHOW HOW MUCH FREE MEMORY *G GET DISK DIRECTORY *L SHOW LOAD ADDRESS OF PROGRAM FILE *M ENABLE ═ICROMON MONITOR *P PRINT SEQENTIAL FILE *Q DISABLE (QUIT) WEDGE *T TEXT EDITOR *U UN-NEW A PROGRAM *X DUMP SCREEN TO PRINTER *! COMPUTER COLD START (RESET) *# CHANGE WEDGE # *= CHANGE DISK DRIVE # (AND WEDGE #) *+ CHANGE BORDER COLOR *- CHANGE BACKGROUND COLOR *\ CHANGE CHARACTER COLOR *? SHOW COMMAND MENU */ LOAD PROGRAM FILE *@ LOAD PROGRAM FILE TO HEADER ADDRESS *^ LOAD PROGRAM FILE AND RUN IT *_ SAVE PROGRAM FILE *: LOAD SEQENTIAL FILE *; SAVE SEQENTIAL FILE *, LOAD USER FILE *. SAVE USER FILE ------------------------------------------------------------------------------ ╘HE FOLLOWING COMMANDS ARE AVAILABLE WHEN USING ═ICROMON (*M) A ASSEMBLER B BREAK SET C COMPARE MEMORY D DISASSEMBLER E DISCONNECT MICROMON F FILL MEMORY G GO RUN H HUNT MEMORY J JUMP TO SUBROUTINE L LOAD MEMORY FROM DEVICE M MEMORY DISPLAY N NEW LOCATOR O OFFSET OR BRANCH CALCULATE P PRINTER TOGGLE (SERIAL BUS) Q QUICK TRACE R REGISTER DISPLAY S SAVE MEMORY TO DEVICE T TRANSFER MEMORY V VERIFY MEMORY WITH DEVICE W WALK THROUGH PROGRAM X EXIT TO BASIC (BRK ENABLED) " ASCII CONVERSION # DECIMAL CONVERSION $ HEX CONVERSION % BINARY CONVERSION & CHECKSUM MEMORY ( ENABLE COMMAND TONE ) DISABLE COMMAND TONE + ADD HEX NUMBERS - SUBTRACT HEX NUMBERS > DISK DIRECTORY ├OMMAND DETAIL AND SYNTAX ╨AGE 2 OF 8 ╔ WROTE THIS PROGRAM WITH SEVERAL OBJECTIVES IN MIND........ ╔ WANTED TO BE ABLE TO ACCESS A LOT OF UTILITY PROGRAMS WITHOUT HAVING TO LOAD THEM IN EVERY TIME ╔ WANTED TO USE ONE. ┴LSO, ╔ DID NOT WANT IT TO SLOW DOWN THE RUNNING OF PROGRAMS, CHANGE ANY OF THE STANDARD BASIC COMMANDS, NOR USE UP ANY OF THE BASIC MEMORY SPACE. ╔ ALSO WANTED TO BE ABLE TO USE ABBREVIATED ─╧╙ COMMANDS. ╘HE WEDGE RESIDES IN MEMORY FROM HEX $A001 TO $CFFF. ┴NY PROGRAM THAT DOES NOT USE MEMORY IN THIS RANGE SHOULD BE ABLE TO CO-EXIST. ╫HEN ═ICROMON IS IN USE, THE CASETTE BUFFER IS ALSO USED. ┴BOUT 2/3 OF THE MEMORY USED BY THE WEDGE IS UNDER THE BASIC ROM. ╙INCE THE WEDGE IS ALL MACHINE LANGUAGE, BASIC IS NOT NEEDED TO PERFORM ANY OF THE WEDGE COMMANDS, AND IS SWITCHED OUT (TEMPORARILY) WHILE THEY ARE BEING PERFORMED. ┴LL WEDGE COMMANDS MUST BE PRECEEDED BY AN ASTERISK (*). ╘HE ASTERISK TELLS BASIC (DIRECT MODE ONLY) THAT THE COMMAND THAT FOLLOWS SHOULD BE TURNED OVER TO THE WEDGE INTERPRETER. ┘OU CAN LOAD THE WEDGE WITH THE FOLLOWING COMMAND: LOAD"WEDGE",8,1 ╬EXT, ╬┼╫ AND ENABLE THE WEDGE WITH ╙┘╙49152. ╘HE WEDGE IS NOW READY AND SET TO COMMUNICATE WITH DISK DRIVE # 8 (DEFAULT SETTING). ╧R YOU CAN USE THE BOOT PROGRAM (BOOTWG.IMG) TO AUTOMATICALLY LOAD, ENABLE THE WEDGE AND DISPLAY THE COMMAND MENU FOR YOU. ╠IKE THIS: LOAD"BOOT",8,1 ╘HE BOOT AND THE WEDGE MUST BE ON THE SAME DISK. ╥ENAME THE WEDGE PROGRAM ╫┼─╟┼ AND THE BOOT PROGRAM ┬╧╧╘ IF YOU DIDN'T DO THAT ALREADY, OR ALL YOU'LL GET IS AN I/O ERROR #4 (FILE NOT FOUND) WHEN YOU TRY TO USE THE BOOT. ------------------------------------------------------------------------------ ╬OTES: ╒NLESS OTHERWISE NOTED, ANY REFERENCES TO NUMBERS CAN BE IN DECIMAL OR HEX. ╔F YOU SPECIFY HEX, THE NUMBER MUST BE PRECEEDED BY THE $ SYMBOL. ┼XAMPLE ---- 42 (DECIMAL) OR $2A (HEX) ├OMMANDS WHICH WRITE DATA TO BUFFERS IN THE 64 WILL NOT DISTURB BASIC PROGRAMS, NOR WILL THEY OVERWRITE VARIABLES OR STRINGS. ┬UFFERS ARE ALLOCATED BY THE WEDGE FROM AREAS THAT HAVE NOT YET BEEN USED BY YOUR BASIC PROGRAMS. ╘HE WEDGE FINDS THESE AREAS BY READING THE VECTORS AT LOCATIONS 49 THROUGH 52. ------------------------------------------------------------------------------ * ╘HIS COMMAND ALONE WILL READ THE ERROR CHANNEL OF THE DISK DRIVE AND PRINT IT ON THE SCREEN. ------------------------------------------------------------------------------ ** ╙ENDS ANY TEXT FOLLOWING THE ** TO THE DISK DRIVE AS A ─╧╙ COMMAND. ┼XAMPLES: **N:DISKNAME,ID -> FORMATS A DISK **I -> INITIALIZES THE DRIVE **S:FILENAME -> SCRATCHES A FILE **V -> VALIDATES A DISK **R:NEWNAME=OLDNAME -> RENAMES A FILE ------------------------------------------------------------------------------ *A,10 *A,1000,10 *A ╘HIS COMMAND CAN TAKE ANY OF THOSE THREE FORMS. ╘HE FIRST WILL ENABLE AUTO LINE NUMBER FEEDS. ┴FTER GIVING THE COMMAND, YOU CAN START THE PROCESS BY TYPING IN A BASIC PROGRAM LINE. ╫HEN YOU PRESS RETURN, THE NEXT LINE NUMBER WILL BE WAITING FOR YOU ON THE FOLLOWING LINE, AND THE CURSOR WILL BE WAITING ONE SPACE TO THE RIGHT OF THE NUMBER. ┴UTO LINE NUMBER FEEDS WILL BE DISCON- NECTED AUTOMATICALLY WHEN ANY FUNCTION IS PERFORMED OTHER THAN EDITING OR ENTERING PROGRAM LINES. ╘HIS INCLUDES LISTING OR RUNNING PROGRAMS, POKES, PEEKS, ETC. (OTHERWISE IT WOULD INTERFERE WITH THESE FUNCTIONS). ╘HE NUMBER FOLLOWING THE COMMA CAN BE ANY NUMBER FROM 1 TO 63999. ╨AGE 3 OF 8 ╘HE SECOND FORM OF THIS COMMAND (TWO NUMBERS) IS USED TO RENUMBER A BASIC PROGRAM RESIDING IN THE 64. ╘HE FIRST NUMBER IS THE NUMBER YOU WANT THE FIRST LINE TO BE, AND THE SECOND IS THE STEP SIZE BETWEEN LINE NUMBERS. ╘HE THIRD FORM OF THIS COMMAND DISCONNECTS AUTO LINE NUMBER FEEDS. ------------------------------------------------------------------------------ *BR,$20,$2 *BW,$20,$2 ╘HE *BR COMMAND WILL READ A BLOCK OF DATA FROM THE DISK, DISPLAY THE LOCATION OF THE BUFFER WHERE THE DATA IS STORED, AND ENABLE ═ICROMON SO THAT YOU CAN DISPLAY THE DATA (SEE ═ICROMON COMMAND DOCS). ╙INCE ═ICROMON DISPLAYS IT'S INFORMATION IN HEX, IT'S USUALLY A GOOD IDEA TO SPECIFY HEX NUMBERS IN THE BLOCK-READ AND BLOCK-WRITE WEDGE COMMANDS (TO AVOID CONFUSION). ╘HE FIRST NUMBER IS THE TRACK, THE SECOND IS THE SECTOR (BLOCK). ╘HE *BW COMMAND WILL WRITE A BLOCK OF DATA FROM THE BUFFER TO A BLOCK ON THE DISK. ╘HIS COMMAND IS USUALLY USED AFTER A BLOCK-READ COMMAND, WHERE YOU HAVE MODIFIED THE DATA AND WISH TO WRITE IT BACK TO THE BLOCK. ╘HIS COMMAND IS VERY POWERFUL. ╔F YOU GOOF USING IT, YOU CAN REALLY MESS UP A DISK, SO IT'S A GOOD IDEA TO HAVE AN EXTRA COPY OF THE DISK ON HAND AS INSURANCE. ╞OR THIS REASON, YOU WILL ALSO BE PROMPTED TO CONFIRM YOUR INTENT TO WRITE TO THE BLOCK (MAKES YOU THINK ABOUT IT ONE LAST TIME). ------------------------------------------------------------------------------ *C:FILENAME *C:FILENAME,TYPE *C* *C** ╘HE *C:FILENAME COMMAND IS USED TO MAKE COPIES OF SINGLE FILES. ╘HE FILE IS READ INTO A BUFFER FROM THE SOURCE DISK, AND YOU ARE PROMPTED FOR ANOTHER DISK (MUST BE FORMATTED). ╧NCE YOU HAVE INSERTED THE DESTINATION DISK, PRESSING ╥┼╘╒╥╬ WILL CAUSE THE BUFFERED FILE TO BE WRITTEN TO IT. ╞OR LARGE FILES, IT WILL BE NECESSARY TO SWAP THE DISKS UNTIL THE ENTIRE FILE IS COPIED (YOU WILL BE PROMPTED TO DO SO). ┼XAMPLE....*C:WEDGE WILL COPY THE FILE NAMED "WEDGE". ╬O NEED TO SPECIFY FILE TYPE, AS THAT INFO IS READ FROM THE DIRECTORY. ╔F YOU USE THIS COMMAND ON A FILE THAT HAS BEEN SCRATCHED, IT WILL RECOVER THE FILE (NOT COPY IT). ╘HE FILE WILL BE RECOVERED AS A PROGRAM FILE UNLESS YOU SPECIFY OTHERWISE, AS IN THE FOLLOWING COMMAND. ╘HE *C:FILENAME,TYPE COMMAND IS USED TO CHANGE FILE TYPES, OR TO RECOVER SCRATCHED FILES AS A PARTICULAR FILE TYPE. ╞OR EXAMPLE, *C:WEDGE,S WILL CHANGE THE FILE NAMED "WEDGE" TO A SEQENTIAL FILE, OR WILL RECOVER A SCRATCHED FILE NAMED "WEDGE" AS A SEQENTIAL FILE. ╧NE FINAL NOTE ON COPYING SINGLE FILES........RELATIVE FILES ARE NOT SUPPORTED. ╚OWEVER, YOU CAN COPY RELATIVE FILES WITH THE NEXT 2 COMMANDS. ╘HE *C* COMMAND WILL MAKE A COPY OF THE ENTIRE DISK. ─ISKS WITH A LOT OF DATA ON THEM WILL NEED TO BE SWAPPED A FEW TIMES (YOU'LL BE PROMPTED), AND THE DESTINATION DISK MUST ALREADY BE FORMATTED. ┴LL BLOCKS ALLOCATED IN THE ┬┴═ WILL BE COPIED. ╘HE *C** COMMAND WILL CAUSE ALL BLOCKS TO BE COPIED, WHETHER THEY ARE ALLOCATED IN THE ┬┴═ OR NOT. ------------------------------------------------------------------------------ *D100-400 *D-300 *D200- ─ELETES A SPECIFIED RANGE OF PROGRAM LINES. ╔N THE FIRST EXAMPLE, ALL LINES FROM 100 TO 400 (INCLUSIVE) WILL BE DELETED. ╔N THE SECOND, ALL FROM 0 TO 300 AND IN THE THIRD, ALL FROM 200 UP. ╘HIS COMMAND ALSO PERFORMS A ├╠╥. ------------------------------------------------------------------------------ *F ╥EADS OUT HOW MUCH UNUSED MEMORY IS LEFT FOR BASIC IN HEX AND DECIMAL VALUES. ╨AGE 4 OF 8 *G ╨RINTS THE DIRECTORY OF THE DISK TO THE SCREEN. ╘HIS COMMAND WILL NOT DISTURB BASIC PROGRAMS LIKE THE LOAD"$",8 COMMAND DOES. ╨RESSING THE ├╘╥╠ KEY WILL SLOW THE DISPLAY, ANY OTHER KEY WILL STOP IT AND RETURN YOU TO COMMAND MODE. ------------------------------------------------------------------------------ *L:FILENAME ╥EADS OUT THE LOAD ADDRESS OF A PROGRAM FILE IN HEX AND DECIMAL ------------------------------------------------------------------------------ *M ┼NABLES ═ICROMON, A MACHINE LANGUAGE MONITOR PROGRAM. ═ANY VERSIONS OF THIS PROGRAM EXIST, SO ╔ WON'T GO INTO A DETAILED LIST OF THE COMMANDS AND THEIR SYNTAX. ╘HERE IS GOOD DOCUMENTATION AVAILABLE IN ├OMPUTE'S ╞IRST ┬OOK OF ├OMMODORE 64, THOUGH, AND THE VERSION USED IN THE WEDGE IS VERY SIMILAR. ╙OME OF THE DIFFERENCES ARE THAT THE WEDGE VERSION RESIDES UNDER THE BASIC ROM FROM $B000 TO $BFFF, AND IS SUPPORTED BY SEVERAL WEDGE SUBROUTINES; THE 'P' COMMAND TOGGLES THE PRINTER (DEVICE 4) ON THE SERIAL BUS INSTEAD OF ON THE ╥╙232 PORT; ETC. ╬OT DIFFERENT ENOUGH TO MATTER MUCH. ------------------------------------------------------------------------------ *P:FILENAME ╨RINTS A SEQUENTIAL FILE TO THE SCREEN OR TO A PRINTER (DEVICE 4 ON THE SERIAL BUS). ╨RESSING THE ├╘╥╠ KEY WHILE PRINTING TO THE SCREEN WILL SLOW THE DISPLAY, ANY OTHER KEY WILL PAUSE. ╫HILE PAUSED, PRESSING 'X' WILL TERMINATE THE OPERATION, ANY OTHER KEY WILL RESUME IT. ------------------------------------------------------------------------------ *Q ─ISABLES THE WEDGE PROGRAM. ╘O RE-ENABLE IT, YOU MUST ╙┘╙49152. ------------------------------------------------------------------------------ *T ┼NABLES THE TEXT EDITOR...SEE THE ADDITIONAL WRITEUP AT THE END OF THIS ─╧├. ------------------------------------------------------------------------------ *U ╒N-NEW'S A PROGRAM. ╘HIS COMMAND IS USEFUL TO THOSE OF US WHO ACCIDENTIALLY TYPE ╬┼╫ AND WISH WE HADN'T. ╔T WILL RECOVER THE PROGRAM (AS LONG AS YOU HAVEN'T LOADED IN ANOTHER ONE YET). ┴LSO PERFORMS A ├╠╥. ------------------------------------------------------------------------------ *X ─UMPS THE SCREEN TO THE PRINTER. ╘HE COMMAND LINE IS ERASED JUST BEFORE THE DUMP SO THAT YOU CAN COPY THE SCREEN WITHOUT HAVING *X SHOW UP ON YOUR PRINTOUT. ╔T'S GOOD PRACTICE TO ISSUE THIS COMMAND FROM A LINE OTHER THAN THE LAST (ISSUING IT FROM THE LAST LINE WILL CAUSE THE SCREEN TO SCROLL). ╘HIS IS A FAIRLY SIMPLE SCREEN DUMP UTILITY. ╔T WILL NOT SUPPORT BITMAPPED SCREENS, REVERSE VIDEO WILL BE PRINTED AS NON-REVERSE, ETC. ╚OWEVER, IT WILL SUPPORT UPPER AND LOWER CASE CHARACTERS AND ├┬═ GRAPHICS CHARACTERS. ╔T DOES IT BY READING THE REGISTER AT $D011 PRIOR TO OPENING THE PRINTER FILE. ╔F THE MODE IS UPPER/LOWER CASE, A SECONDARY ADDRESS OF 7 IS SENT TO THE PRINTER, ELSE IT SENDS A ZERO INSTEAD. ╘ESTED WITH THE ├┬═ 1525, ╨ROWRITER 8510 AND THE ╚EWLETT-╨ACKARD "╘HINKJET". ------------------------------------------------------------------------------ *! ╙ENDS THE COMPUTER TO IT'S COLD START ROUTINE (SAME AS TYPING ╙┘╙64738) ------------------------------------------------------------------------------ *#9 ╙WITCHES THE WEDGE NUMBER SO THAT YOU CAN COMMUNICATE WITH A DISK DRIVE OF A DIFFERENT ADDRESS (DEVICE 9 IN THIS CASE). ┘OU CAN SPECIFY A DEVICE NUMBER FROM 8 TO 31, BUT YOU MUST SPECIFY IT IN DECIMAL (AS IN THE EXAMPLE). ╨AGE 5 OF 8 *=9 ├HANGES BOTH THE WEDGE NUMBER AND THE NUMBER OF THE DISK DRIVE YOU ARE CURRENTLY COMMUNICATING WITH. ╔F YOU ARE CURRENTLY DEALING WITH DRIVE 8, GIVING THIS COMMAND WILL CHANGE THE DRIVE NUMBER TO 9 AND SET THE WEDGE TO COMMUNICATE WITH DEVICE 9. ╙AME SYNTAX RULES APPLY AS IN *# COMMAND. ------------------------------------------------------------------------------ *+14 *-14 *\5 ╘HESE COMMANDS CHANGE THE BORDER, BACKGROUND AND CHARACTER COLOR RESPECTIVELY. *+14 WOULD CHANGE THE BORDER COLOR TO LIGHT BLUE, *-14 CHANGES BACKGROUND TO LIGHT BLUE, AND *\5 WILL MAKE THE TEXT GREEN. ╬UMBERS MUST BE SPECIFIED IN DECIMAL. ┘OU CAN GIVE THESE COMMANDS WITHOUT NUMBERS (*+ *- OR *\). ╔N THIS CASE, THE COLOR WILL BE INCREMENTED TO THE NEXT HIGHER-NUMBERED ONE. ------------------------------------------------------------------------------ *? ─ISPLAYS AN ABBREVIATED COMMAND MENU FOR QUICK REFERENCE. ------------------------------------------------------------------------------ */FILENAME *@FILENAME *^FILENAME *_FILENAME ╘HE FIRST EXAMPLE LOADS A PROGRAM FILE THE SAME AS LOAD"FILENAME",DEVICE. ╘HE SECOND IS THE SAME AS LOAD"FILENAME",DEVICE,1. ╚OWEVER, THE BASIC POINTERS WILL NOT BE DISTURBED. ╘HIS COMMAND IS USUALLY USED TO LOAD MACHINE LANGUAGE PROGRAMS, AND WORKS THE SAME AS THE ─╧╙ ╫┼─╟┼ COMMAND %FILENAME (LOADS TO THE FILE HEADER ADDRESS). ╘HE THIRD EXAMPLE WILL LOAD AND THEN RUN A PROGRAM (USUALLY USED ON BASIC PROGRAMS). ╘HE FOURTH IS USED TO SAVE A PROGRAM, AS IN SAVE"FILENAME",DEVICE. ╔N ALL OF THESE EXAMPLES, YOU CAN SPECIFY ADDRESSES (OPTIONAL). ╔F YOU SPECIFY ADDRESSES FOR THE SAVE COMMAND, THE SYNTAX MUST FOLLOW THIS FORM: *_FILENAME,ADDR1,ADDR2 ╘HE FIRST ADDRESS IS THE START OF THE SAVE, THE SECOND IS ONE BYTE ═╧╥┼ THAN THE LAST ADDRESS TO BE INCLUDED IN THE SAVE. ┴DDRESSES CAN BE HEX OR DECIMAL. ╞OR THE LOAD COMMANDS, THE SYNTAX IS LIKE THIS: */FILENAME,ADDR *@FILENAME,ADDR *^FILENAME,ADDR ╙PECIFYING A LOAD ADDRESS WILL CAUSE THE BASIC POINTERS TO REMAIN UNTOUCHED, WILL OVERRIDE HEADER ADDRESSES AND CAUSE THE LOAD & RUN (*^) COMMAND TO DEFAULT TO LOAD ONLY. ------------------------------------------------------------------------------ *:FILENAME *;FILENAME ╘HESE COMMANDS WILL LOAD AND SAVE SEQENTIAL FILES, RESPECTIVELY. ╔ USE IT TO PUT FILES INTO ╥┴═ SOMEWHERE (╔ USUALLY SPECIFY AN ADDRESS TO LOAD TO) SO THAT ╔ CAN EXAMINE THE DATA WITH ═ICROMON. ╧NCE IN ╥┴═, THE DATA CAN BE MODIFIED AND WRITTEN BACK, IGNORED, WHATEVER. ┴DDRESSES ARE OPTIONAL HERE, TOO. ------------------------------------------------------------------------------ *,FILENAME *.FILENAME ╠OAD AND SAVE USER FILES, REPECTIVELY. ┴DDRESSES OPTIONAL. ------------------------------------------------------------------------------ ╘┼╪╘ ┼─╔╘╧╥ ─UE TO MEMORY LIMITATIONS, THIS IS A ╙╔═╨╠┼ TEXT EDITOR, BUT IT WILL STILL ALLOW YOU TO DO SOME UNIQUE THINGS. ┘OU CAN LOAD OR SAVE FILES IN STANDARD ┴╙├╔╔ OR ╨┼╘ASCII (├┬═ FILES), SET OR RESET MARGINS OR PAGE LENGTH AT ANY TIME, MERGE TEXT FILES AND MORE. ┴ND, FOR ME ANYWAY, IT'S A VERY UNCOMPLICATED AND EASY TO USE EDITOR. ╬O IMBEDDED COMMANDS, SCIENTIFIC SYNTAX, ETC. ╨AGE 6 OF 8 ├REATING A DOCUMENT ╞ROM THE ┼─╔╘╧╥ MENU, CLEAR THE TEXT BUFFER BY SELECTING 1 AND PRESSING ╥┼╘╒╥╬. ┘OU WILL BE ASKED TO CONFIRM THE COMMAND (JUST A SAFETY PRECAUTION FOR THOSE LIKE ME WHO SOMETIMES FORGET TO SAVE THINGS BEFORE ERASING THEM). ╬EXT, SET UP THE MARGINS AND PAGE LENGTH YOU WANT WITH SELECTION 2. ─EFAULT VALUES ARE: LEFT MARGIN 5, RIGHT 75, LINES PER PAGE 66. ╩UST PRESSING ╥┼╘╒╥╬@3 TIMES WILL PUT THOSE VALUES IN PLACE. ╬OW YOU CAN ENTER THE EDIT MODE WITH SELECTION 3 (DEFAULT MENU SELECTION). ╔F YOU EVER GET A ?╞╧╥═┴╘ ┼╥╥╧╥ MESSAGE, IT WILL PROBABLY BE BECAUSE THE TEXT BUFFER WAS NOT INITIALIZED BEFORE ENTERING THE EDIT MODE FOR THE FIRST TIME, OR THE MARGINS WERE SET TO ILLEGAL VALUES (LEFT > 77 OR TOO CLOSE TO RIGHT OR RIGHT > 80). ╬╧╘┼: ┘OU CAN RETURN TO THE MENU AT ANY TIME BY PRESSING THE ╙╘╧╨ KEY. ╘HE SCREEN WILL CLEAR AND (IF YOU USED THE DEFAULT MARGIN VALUES) YOU WILL SEE BARS AT THE LEFT AND RIGHT SIDES OF YOUR SCREEN. ╘HESE ARE THE MARGIN MARKERS, AND AT THE BOTTOM OF THE SCREEN WILL BE A STATUS LINE. ┘OU WILL NOT BE ABLE TO TYPE INTO THE MARGIN MARKERS, AS THEY ARE THERE TO HELP YOU FORMAT YOUR TEXT AND LET YOU KNOW WHERE YOUR LINES START AND END. ┴LL SCREEN LINES WILL BE COMBINED IN PAIRS AS 80 COLUMN LINES, WHICH WILL LEAVE YOU WITH 12 LINES ON THE SCREEN AT A TIME. ┘OU CAN IDENTIFY WHICH PAGE, LINE AND COLUMN THE CURSOR IS ON BY READING THE STATUS LINE AT THE BOTTOM OF THE SCREEN. ╘YPE A LINE OF TEXT. ┴T THE END OF THE LINE, PRESS ╥┼╘╒╥╬ TO GET TO THE NEXT LINE, OR JUST KEEP ON TYPING. ╫ORDS WILL NOT BE BROKEN AT THE RIGHT MARGIN MARKER, BECAUSE OF THE EDITOR'S AUTOMATIC ╨┴╥╙╔╬╟ FEATURE. ╔F THE LAST LETTER ON A LINE IS NOT A SPACE, THE EDITOR WILL MOVE THE ENTIRE WORD TO THE NEXT LINE FOR YOU. ╘HERE ARE SOME SAFETY FEATURES BUILT INTO THIS ROUTINE, TOO. ╔F THERE IS TEXT ON THE NEXT LINE, PARSING WILL NOT TAKE PLACE. ╘HIS ALLOWS YOU TO EDIT A PREVIOUS LINE WITHOUT ACCIDENTALLY DUMPING TEXT ON THE NEXT ONE. ┴LSO, PARSING WILL NOT OPERATE ON WORDS LONGER THAN 10 CHARACTERS. ╘HAT WAS DONE TO ALLOW THE USE OF LONG STRINGS OF DASHES (AS IN SOME OF THE PREVIOUS LINES IN THIS ─╧├). ╨ARSING IS THERE TO ALLOW YOU TO TYPE WITHOUT HAVING TO WATCH THE SCREEN. ┬E WARY OF SHIFTED SPACES...THE EDITOR TREATS THEM AS CHARACTERS (NOT SPACES), AND THEY CAN CAUSE UNEXPECTED RESULTS, ESPECIALLY IF THEY ARE ON THE NEXT LINE...THE EDITOR WILL NOT PARSE, THINKING THERE IS TEXT THERE. ╘HIS CAN BE USED TO ╞╧╥├┼ A WORD TO STAY ON THE PREVIOUS LINE, SHOULD YOU WANT IT TO. ┴N EXAMPLE OF THIS IS THE WORD AT THE END OF THIS LINE.. END. @ ├╒╥╙╧╥ ╦┼┘╙ ├URSOR RIGHT AND LEFT WORK AS YOU WOULD EXPECT THEM TO. ├URSOR UP AND DOWN ARE A BIT DIFFERENT. ╘HEY MOVE THE CURSOR 2 SCREEN LINES AT A TIME (WHICH IS REALLY ╧╬┼ 80 ├╧╠╒═╬@╠╔╬┼). ╘HE INSERT AND DELETE KEYS WILL WORK AS EXPECTED, BUT ONLY ON THE CURRENT LINE. ╫HEN HOLDING THE DELETE KEY DOWN, THE CURSOR WILL MAKE IT'S WAY ONLY AS FAR AS THE LEFT MARGIN. ╔F YOU WANT TO DELETE PART OF THE PREVIOUS LINE, MOVE THE CURSOR THERE WITH A CURSOR LEFT, AND THEN CONTINUE DELETING. ╘HE INSERT KEY WILL PUSH ALL TEXT FROM THE CURSOR POSITION ON TOWARDS THE RIGHT MARGIN. ╘EXT PUSHED INTO THE RIGHT MARGIN CANNOT BE RECOVERED. ╘HE HOME KEY WORKS NORMALLY, BUT SCREEN CLEAR IS NOT SUPPORTED. @ ├╘╥╠ ─ AND ├╘╥╠ ╔ ├╘╥╠ D WILL DELETE THE CURRENT LINE AND DRAW ALL FORWARD LINES IN TO CLOSE THE GAP. ├╘╥╠ I WILL OPEN UP A BLANK LINE, PUSHING ALL LINES FORWARD FROM THE CURRENT LINE ON. ╚OLDING ├╘╥╠ D OR ├╘╥╠ I WILL ALLOW YOU TO QUICKLY DELETE OR INSERT LARGE PORTIONS OF TEXT. ╨AGE 7 OF 8 ╙├╥╧╠╠╔╬╟ ╘╚┼ ╙├╥┼┼╬ ┴╬─ ╘╚┼@╘┼╪╘@┬╒╞╞┼╥ ┴TTEMPTING TO MOVE THE CURSOR PAST THE BOTTOM OF THE SCREEN WILL CAUSE THE SCREEN TO SCROLL FORWARD. ╥EVERSE SCROLLING WILL HAPPEN AT THE TOP OF THE SCREEN. ╫HEN YOU MOVE THE CURSOR TO THE END OF AVAILABLE MEMORY, FORWARD MOVEMENT WILL STOP. ╘HE SAME IS TRUE FOR REVERSE MOVEMENT AT THE SCREEN'S TOP. @ ╔F YOU PLAN TO CREATE OR LOAD A BIG DOCUMENT, YOU SHOULD FREE UP AS MUCH MEMORY AS POSSIBLE BY TYPING ╬┼╫ IN THE COMMAND MODE PRIOR TO ENTERING THE EDITOR. ┬E SURE TO CLEAR TEXT MEMORY TOO, OR YOU MAY GET A SCREENFUL OF "GARBAGE" OR A ?╞╧╥═┴╘ ┼╥╥╧╥ MESSAGE WHEN YOU ATTEMPT TO ENTER THE EDIT MODE. 481 LINES ARE AVAILABLE WITH A BIG BUFFER LIKE THIS (8 PAGES AT 60 LINES PER). @ ╠╧┴─╔╬╟ ╞╔╠┼╙ ┘OU CAN LOAD AN ┴╙├╔╔ FILE OR A ╨┼╘-┴╙├╔╔ FILE. ╔F THE FILE WAS NOT CREATED WITH THIS EDITOR, THE MARGINS WILL DEFAULT TO 0 (LEFT) AND 80 (RIGHT), OTHERWISE THE EDITOR WILL CREATE THE MARGINS FROM INFORMATION CONTAINED IN THE FIRST FEW BYTES OF THE FILE. ═ORE ON HOW IT DOES THIS LATER. ╔T'S A GOOD IDEA TO CLEAR TEXT MEMORY BEFORE A LOAD, THOUGH, OR YOU WILL HAVE SOME MERGED TEXT...IT'S SURPRISED ME AT TIMES. ╘HIS CAN ALSO BE USED TO SOME ADVANTAGE. ┴FTER A LOAD, YOU WILL BE RETURNED TO THE EDITOR MENU. ╨RESSING ╥┼╘╒╥╬@WILL PUT YOU INTO THE EDIT MODE WHERE YOU CAN READ THE FILE, EDIT IT OR RE-SAVE IT AS EITHER AN ┴╙├╔╔ OR ╨┼╘-┴╙├╔╔ FILE. ╔ USE THE LATTER TRICK TO CONVERT FILES ALL THE TIME. ╙┴╓╔╬╟@╞╔╠┼╙ ╙AME OPTIONS ARE AVAILABLE, BUT YOU MAY WANT TO KNOW A FEW OF THE ▌ECHNICAL DETAILS OF THE SAVE. ┴LL BLANK LINES ARE SAVED AS A CARRIAGE RETURN (OR A CARRIAGE RETURN AND LINEFEED FOR ┴╙├╔╔ FILES). ┴LSO, CARRIAGE RETURNS ARE ADDED AT THE END OF PAGES TO PROVIDE PERFORATION SKIPS FOR YOUR PRINTER. ╘HE EDITOR WILL ASSUME YOUR TEXT PAGE IS 66 LINES PER PAGE. ╔F YOU HAVE YOUR LINES PER PAGE SET AT 60 (FUNCTION 2 FROM THE MENU), 6 CARRIAGE RETURNS WILL BE ADDED AFTER EVERY 60 LINES. ╔F YOU DON'T WANT THESE ADDED TO YOUR FILE, JUST RESET THE LINES PER PAGE TO 66 PRIOR TO SAVING THE FILE. ╔F YOU RELOAD A FILE THAT HAS THESE EXTRA ├╥'S, YOU'LL SEE BLANK LINES INSERTED IN YOUR TEXT. ╥ESAVING SUCH A FILE WITHOUT FIRST DELETING THESE LINES COULD CAUSE CHAOS IN YOUR PAGE FORMATTING, SO BE SURE YOU EITHER DELETE THE LINES OR RESET THE LINES PER PAGE TO 66 PRIOR TO RESAVING. ┴LSO, IF YOU SAVE A FILE THAT "MAXED OUT" YOUR TEXT BUFFER, THE EXTRA ├╥'S WILL CAUSE A RELOAD TO IGNORE THE LAST PART OF YOUR LENGTHENED DOCUMENT, SO BE AWARE OF THESE DETAILS WHEN YOU SAVE. ┴LL FILES SAVED BY THE EDITOR CONTAIN INFORMATION FOR SETTING UP THE LEFT AND RIGHT MARGINS. ╘HIS INFORMATION IS CONTAINED IN THE FIRST FEW BYTES. ╘O EXPLAIN THIS, LET'S ASSUME YOU ARE SAVING A DOCUMENT WITH A LEFT MARGIN OF 5 AND A RIGHT MARGIN OF 75. ╘HE FIRST 5 BYTES OF THE FILE WILL BE NULLS (BINARY ZEROS), THE NEXT BYTE WILL BE A 128 (SEPARATOR) AND THE NEXT 5 BYTES WILL BE NULLS. ╘O PRINTERS, NULLS AND 128'S ARE TRANSPARENT...THEY ARE IGNORED. ╘HESE CHARACTERS ARE ALSO IGNORED BY MOST ┬┬╙ SYSTEMS. ├╔╙ IGNORES THEM JUST FINE. ╚OWEVER, THE EDITOR DOES NOT IGNORE THEM, AND USES THEM TO SET UP THE MARGINS WHEN YOU LOAD THE FILE. ╔F YOUR MARGINS WERE SET TO 0 LEFT & 80 RIGHT, NO NULLS OR SEPARATOR BYTES WILL BE SAVED IN THE FILE. ╘HIS MAKES THE EDITOR USEFUL FOR CREATING OR EDITING SOURCE CODE FILES FOR AN ASSEMBLER (LIKE THE ├┬═ ASSEMBLER). ═┼╥╟╔╬╟ ╘┼╪╘ ╞╔╠┼╙ ╨AGE 8 OF 8 ╚ERE'S HOW YOU DO IT...LOAD THE FIRST FILE AND PLACE THE CURSOR PAST THE LAST LINE IN THE FILE (IN THE EDIT MODE). ╨RESS THE ╙╘╧╨ KEY TO TAKE YOU BACK TO THE MENU AND LOAD THE SECOND FILE. ╘HE SECOND FILE WILL START LOADING FROM THE LINE YOU LEFT THE CURSOR ON WHEN YOU WENT TO THE MENU. ┴RMED WITH THAT INFORMATION, ONE COULD MERGE (OR INSERT) TEXT FROM ONE FILE INTO ANOTHER JUST BY LEAVING THE CURSOR IN THE APPROPRIATE PLACE IN THE TEXT. ┘OU CAN EVEN DO A "CUT AND PASTE" OPERATION BY OPENING UP A GAP IN YOUR TEXT WITH ├╘╥╠ I AND MERGING TEXT FROM ANOTHER FILE INTO THE GAP. ┬Y NOW YOU HAVE PROBABLY FOUND OUT THAT YOU CAN LEAVE THE EDITOR AND DO OTHER THINGS WITHOUT LOSING YOUR DOCUMENT. ╔F YOU USE ANOTHER WEDGE FUNCTION THAT WRITES TO A BUFFER (LIKE *B, *C, ETC.), OR DISTURB THE BASIC START-OF-VARIABLE STORAGE POINTER, YOU'LL HAVE A LOT OF TROUBLE RECOVERING YOUR DOCUMENT. ╫HAT YOU ├┴╬ DO IS EXIT TO PRINT, SCRATCH OR RENAME A FILE, READ THE DIRECTORY, OR USE ANY OTHER COMMAND THAT DOESN'T DISTURB POINTERS OR RE-ALLOCATE BUFFERS. ╨╥╔╬╘╔╬╟ ┴ ╞╔╠┼ ╒SE THE WEDGE *P SEQ FILE PRINTER FOR THIS. ╘HE FILE MUST BE A ╨┼╘-┴╙├╔╔ FILE, SO IF YOU WANT TO PRINT AN ┴╙├╔╔ FILE, YOU WILL HAVE TO LOAD IT AND SAVE IT BACK AS A ╨┼╘ FILE PRIOR TO PRINTING IT. ─ON'T FORGET TO SAVE IT WITH THE APPROPRIATE LINES PER PAGE (WITH OR WITHOUT PERF SKIP CARRIAGE RETURNS). ╒╙╔╬╟ ╠┼╘╘┼╥.╔═╟ ╞╔╠┼╙ ╔F YOU HAVE TEXT FILES CREATED BY ╠┼╘╘┼╥.╔═╟ (IN THE OTHER ├┬═ SIG), YOU CAN LOAD THEM INTO MEMORY DIRECTLY WITH THE WEDGE AND CONVERT THEM TO NORMAL TEXT FILES WITH THE EDITOR. ╠┼╘╘┼╥ FILES ARE MADE UP OF SCREEN CODES, WITH THE FIRST 48 BYTES OF THE FILE CONTAINING FORMATTING VARIABLES. ╘HE EDITOR STORES TEXT IN MEMORY (AND UPDATES THE SCREEN) WITH SCREEN CODES ALSO, SO HERE'S HOW YOU DO IT: ╞REE UP ALL AVAILABLE MEMORY WITH ╬┼╫ AND ENTER THE EDITOR. ├LEAR TEXT MEMORY AND SET THE MARGINS TO 0 AND 80. ╬EXT, RETURN TO COMMAND LEVEL AND LOAD THE ╠┼╘╘┼╥ FILE WITH THIS COMMAND: *:FILENAME,$08D0 ╥E-ENTER THE EDITOR AND GO DIRECTLY INTO THE EDIT MODE, MOVING THE CURSOR TO THE END OF THE TEXT TO SET UP THE DOCUMENT END POINTER. ╔F MARGINS DON'T LOOK RIGHT, YOU CAN RESET THEM FROM THE EDITOR MENU (SELECTION 2). ╔F YOU RESAVE THE FILE WITH THE EDITOR, ANY REVERSE VIDEO CHARACTERS WILL BE CONVERTED TO NON REVERSE, SINCE THE EDITOR DOES NOT SUPPORT THOSE ENHANCEMENTS (AS ╠┼╘╘┼╥.╔═╟ DOES). ┴LSO, YOU WILL NOT BE ABLE TO PASS EDITOR FILES BACK THE OTHER WAY, ONLY FROM ╠┼╘╘┼╥.╔═╟ TO THE EDITOR, AS DESCRIBED ABOVE. ****************************************************************************** ╫ELL, THAT'S THAT. ╔'D APPRECIATE FEEDBACK FROM THOSE OF YOU WHO DOWNLOAD THIS PROGRAM, AND MY THANKS GO TO THOSE OF YOU WHO PROVIDED SUCH FEEDBACK ON THE ORIGINAL TWO UPLOADS. ╙OME OF THE IDEAS YOU HAD WERE INCORPORATED INTO THIS VERSION, AND SOME ╔ HAD TO PUT ASIDE DUE TO MEMORY LIMITATIONS, BUT ╔ APPRECIATED THEM ALL. ╥EGARDS, ╩IM ╦LITZING [75206,2536] ╦EY <┼╬╘┼╥> TO CONTINUE: